home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 32 / Mac Magazin and MacEasy Magazine CD - Issue 32.iso / Grafik & Text / Textures BBEdit Tool / textures tool manual < prev    next >
Text File  |  1997-02-07  |  6KB  |  141 lines
  1. BBEdit Textures Tool
  2. --------------------
  3.  
  4.      by Brad Hanson (bhanson@avalon.net, BradH5@aol.com)
  5.      February 6, 1997 - Version 1.0.1
  6.  
  7.  
  8.     The document describes a BBEdit tool that facilitates the use of
  9.     BBEdit as an external editor for Textures. Textures is an
  10.     implementation of the TeX typesetting language for the
  11.     Macintosh. Information about Textures is available at
  12.  
  13.         http://www.bluesky.com/textures.html
  14.  
  15.  
  16.     The latest version of this tool is available at
  17.  
  18.        ftp://members.aol.com/bradh5/textures_bbedit_tool.sit
  19.  
  20.  
  21.     A web page describing this tool and other BBEdit extensions I
  22.     have written is
  23.  
  24.        http://members.aol.com/bradh5/bbedit_extensions.html
  25.  
  26.  
  27.     This tool is a 68K BBEdit tool and should work on a 68K or
  28.     PowerPC Macintosh with Textures version 1.8 or later, and BBEdit
  29.     version 3.5.2 or later (although I have only tested it with
  30.     BBEdit 4.0.2). BBEdit tools cannot be used with BBEdit Lite. The
  31.     tool requires Macintosh system software version 7.0 or later.
  32.  
  33.     This tool is freeware. If you have any questions or comments, or
  34.     would like a copy of the source code, please let me know.
  35.  
  36. Using the Textures Tool
  37. -----------------------
  38.  
  39.     To install the tool quit BBEdit and put the tool in the "BBEdit
  40.     Extensions" folder that is in the same folder as the BBEdit
  41.     application. The tool is started by selecting "Textures" from
  42.     the BBEdit Extensions menu. A command key can be assigned to the
  43.     tool by using the "Set Keys" item in the BBEdit Extensions menu.
  44.     If Textures is not running when the Textures tool is started an
  45.     attempt is made to launch Textures.
  46.  
  47.     After the tool is started a floating window (named "Textures")
  48.     is displayed containing a list of the TeX formats available for
  49.     typesetting (these are the formats listed in the Typeset menu of
  50.     Textures). There are two buttons at the top of the Textures tool
  51.     window - a "Run" button, and a "Close" button.
  52.  
  53.     Selecting a format and clicking on the Run button will send a
  54.     command to Textures to start a typesetting job using the text in
  55.     the active BBEdit window, and will bring Textures to the front.
  56.     If the active BBEdit window is not a new document (the document
  57.     exists on disk) the file containing the document is sent to
  58.     Textures for typesetting. This means that if the active BBEdit
  59.     window contains changes that have not been saved, those changes
  60.     will not be reflected in the typesetting results since the file
  61.     as currently saved to disk will be sent to Textures for
  62.     typesetting. If changes have been made to an active BBEdit
  63.     window that exists on disk, the Save command in BBEdit must be
  64.     used before the file is typeset for the changes to appear in the
  65.     typesetting results.
  66.  
  67.     If the active BBEdit window contains a new document (has not
  68.     been saved to disk) then clicking on the Run button in the
  69.     Textures tool window will send the text in the window to
  70.     Textures for typesetting. In this case a file does not exist to
  71.     send to Textures, so the text in the window is sent instead.
  72.  
  73.     After a typesetting job has been started an Edit window
  74.     containing the contents of the active BBEdit window and an
  75.     associated Typeset window are created in Textures. If the
  76.     document in the active BBEdit window exists as a file on disk,
  77.     that file will be open in the Textures Edit window. The name of
  78.     the window will be the file name. If the active BBEdit window is
  79.     a new document (not saved to disk) the Textures Edit window will
  80.     have a name like "as27239728" (the number will be different).
  81.  
  82.     Closing the Edit window in Textures associated with a
  83.     typesetting job started in BBEdit will not close the job (the
  84.     Edit and Typeset window names will still appear in the Windows
  85.     menu of Textures even though the Edit window is closed). The job
  86.     must be closed by the BBEdit Textures tool. Any typesetting job
  87.     started by the BBEdit Textures tool will be automatically closed
  88.     if another typesetting job is started with the Textures tool
  89.     (only one typesetting job started by the Textures tool can be
  90.     active at a time), or the Textures tool window is closed. A
  91.     typesetting job can be manually closed by clicking on the Close
  92.     button in the Textures tool window. If the Close button is
  93.     dimmed this means no typesetting job started by the Textures
  94.     tool is active.
  95.  
  96.     There is generally no need to use the Close button since
  97.     typesetting jobs are automatically closed when a new job is
  98.     started or the Textures tool window is closed. A situation in
  99.     which the Close button may be useful is in stopping a running
  100.     typesetting job. To stop a running typesetting job that was
  101.     begun by the Textures tool, switch to BBEdit and click on the
  102.     Close button in the Textures tool window.
  103.  
  104.     The Textures Edit window associated with a typesetting job can
  105.     be manipulated in the same manner as an Edit window opened
  106.     directly by Textures. For instance, the text can be edited, and
  107.     the Save and Save As commands can be used. Any changes to the
  108.     Textures Edit window will not appear in the BBEdit window from
  109.     which the job was begun. If the Textures Edit window is saved,
  110.     and the BBEdit window from which the job was run exists on disk,
  111.     then the modifications made in Textures can be made to appear in
  112.     the associated BBEdit window by doing the following:
  113.  
  114.     1   Bring BBEdit to the front.
  115.  
  116.     2   Make some modification to the BBEdit window so that the "Revert
  117.         to Saved" item in File menu becomes undimmed. Any
  118.         modification that changes the text in someway, like adding a
  119.         space someplace, can be used. The modified text will be
  120.         replaced in the next step.
  121.  
  122.     3   Select "Revert to Saved" from the File menu and click on the
  123.         Revert button in the resulting dialog. The modified file as
  124.         saved from Textures will appear in the BBEdit window.
  125.  
  126.  
  127. Version History
  128. ---------------
  129.  
  130.     February 6, 1997 - Version 1.0.1
  131.  
  132.     *   During idle time the extension now checks to see if Textures is
  133.         still running, so the extension will no longer think a
  134.         Textures job is running when Textures has been quit.
  135.  
  136.  
  137.     December 14, 1996 - Version 1.0
  138.  
  139.     *   Initial release.
  140.  
  141.